Sertifi API Web Service
Method/Services/GetFileStatus
Description
Get a detailed xml output for a file's status, including document and signature information.
Request (GetFileStatusSoapIn)

The request body is of type GetFileStatus.

Request Body Parameters

NameDescriptionData Type
pstr_APICodeThe API code of the site.  This can be found through your Sertifi web interface under Administration -> Account Settings.xml:string
pstr_FileIDThe id of the relevant file.xml:string
includeDocumentDatabaseXMLInclude the data filled in on the documents.  Default = False.xml:boolean
includeDocumentDatabaseXML Element pstr_FileID Element pstr_APICode Element Sequence GetFileStatus Element
Response (GetFileStatusSoapOut)

The response body is of type GetFileStatusResponse.

Response Body Parameters

NameDescriptionData Type
GetFileStatusResultFile status xml or error message.xml:string
GetFileStatusResult Element Sequence GetFileStatusResponse Element
Example

Sample Call:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ser="http://apps.sertifi.net/services/">
   <soap:Header/>
   <soap:Body>
      <ser:GetFileStatus>
         <ser:pstr_APICode>88F54943-115A-4BD7-B325-52262BCA2F98</ser:pstr_APICode>
         <ser:pstr_FileID>dpZaMtBrYvE=</ser:pstr_FileID>
         <ser:includeDocumentDatabaseXML>false</ser:includeDocumentDatabaseXML>
      </ser:GetFileStatus>
   </soap:Body>
</soap:Envelope>

Sample Response:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <GetFileStatusResponse xmlns="http://apps.sertifi.net/services/">
         <GetFileStatusResult><![CDATA[<?xml version="1.0" encoding="utf-16"?>
<File>
  <Code>dpZaMtBrYvE=</Code>
  <Name>yadayada reassign</Name>
  <Status>1</Status>
  <Signer>
    <Email>[email protected]</Email>
    <Signed>0</Signed>
    <Open>1</Open>
    <SignerType>1</SignerType>
    <DateInvited>09/29/2014 12:55:33AM</DateInvited>
    <DateLastVisit>1/1/0001 12:00:00 AM</DateLastVisit>
  </Signer>
  <Document>
    <DocumentID>+7tvlFanzEU=</DocumentID>
    <Name>checkboxes!</Name>
    <Status>Unsigned</Status>
    <DateCreated>9/29/2014 12:35:40 PM</DateCreated>
    <DateSigned>1/1/0001 12:00:00 AM</DateSigned>
    <Signatures>
      <Email>[email protected]</Email>
      <NameSigned />
      <IpAddress />
      <SignMethod>Electronic</SignMethod>
      <DateSigned>1/1/0001 12:00:00 AM</DateSigned>
      <SignerType>1</SignerType>
    </Signatures>
  </Document>
</File>]]></GetFileStatusResult>
      </GetFileStatusResponse>
   </soap:Body>
</soap:Envelope>

Remarks
Common Errors include:
"ERROR: Invalid API Code"
"ERROR: File could not be accessed"
See Also
All Operations Resource GroupSertifi API Web Service

 

 


© Sertifi, Inc., 2016 All Rights Reserved.

Send comments on this topic.